home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / splitter.lzh / SPLITTER.DOC < prev    next >
Text File  |  1994-03-29  |  6KB  |  141 lines
  1.                              -*- Splitter v2.0 -*-
  2.  
  3.                  A >>SHAREWARE<< program by S.Coates & M.J.Matts
  4.  
  5.  
  6.       Shareware conditions
  7.       ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  8.       If you use Splitter and consider it useful enough to continue using 
  9.       it then please consider making a donation to the authors. I would 
  10.       suggest £10 UK pounds as a resonable donation. Any donations should 
  11.       be sent to the address at the end of this doc file and thanks in 
  12.       advance for anything..
  13.  
  14.       Magazine & PDL Conditions
  15.       ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  16.       Splitter may be distributed freely by any PD Library or BBS but it
  17.       may *NOT* be used on any magazine cover disk without permission from
  18.       the authors first, any  magazine failing to comply  with this request
  19.       will have action taken against them. Disk only magazines are free to
  20.       place Splitter  on the disk  without the authors permission on the
  21.       condition  that a copy of the relevant edition is sent to the authors 
  22.       in advance of publication.
  23.  
  24.       Please do not remove any files from this archive if you intend to 
  25.       distribute it further.
  26.  
  27.       What files you should have
  28.       ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  29.       SPLITTER.TTP : Main file splitting/building program
  30.       SPLITTER.PRG : GEM shell for easy use of SPLITTER.TTP
  31.       SPLITTER.DOC : This file!
  32.       SPLITTER.C   : Full ANSI 'C' source for SPLITTER.TTP
  33.       FILE_ID.DIZ  : Description of SPLITTER for BBS's
  34.       BBS_ADS.TXT  : BBS adverts.
  35.  
  36.       If any of these files are missing please notify the authors stating 
  37.       where you obtained the archive from.
  38.  
  39.       And now about the program itself!
  40.       ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  41.       Splitter was written after a request from Alan Woodcock (Desktop 
  42.       Services) who wanted to be able to ship a 1meg+ scanned image file to 
  43.       another machine via floppy disks, obviously the size of the file 
  44.       presented a major problem, especially if it had already been packed 
  45.       with LZH,ZIP or another archiver. Splitter allows you to overcome 
  46.       this barrier by breaking the large file into smaller blocks, and then
  47.       rebuilding it to it's original form.
  48.  
  49.  
  50.       How to use Splitter.
  51.       ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  52.       The main Splitter program was previously written in GFA Basic which 
  53.       made it an Atari specific program, for v2 it has been rewritten in C 
  54.       using ANSI compliant code and has been successfully compiled without 
  55.       any changes on the following platforms:
  56.  
  57.       Atari ST - Lattice C 5.60
  58.       Atari ST - GNU C 2.4.5
  59.       MSDOS 6.20 - GNU C (32 Bit)
  60.       OS/2 2.1 - GNU C
  61.       Sequent Dynix/PTX 2.10
  62.       IBM RS/6000 AIX 3.2.0
  63.  
  64.       This will now allow split files to be rebuilt on computers other 
  65.       than Atari's. With the Atari ST release you have the added advantage 
  66.       of an easy to use GEM interface which will make it much easier to 
  67.       use.
  68.  
  69.       The main display of the Splitter shell allows you to control every 
  70.       feature of the program quickly and very easily.  The following text 
  71.       will describe each step which you should take for splitting or 
  72.       rebuilding a file.
  73.  
  74.       Setting a block size
  75.       ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  76.       There are 3 ways to set your maximum block size. One is to manually 
  77.       enter the size in bytes, secondly you can click on either of the 
  78.       buttons to increase or decrease the value by 1 byte and lastly by 
  79.       double clicking on the buttons which will increase or decrease the 
  80.       block size by 1024 bytes at a time. Please note that you can hold 
  81.       the mouse button down to repeat the procedure and that a minimum 
  82.       block size of 1024 bytes will always be assumed, that is you can 
  83.       define any block size from 1024 to 9999999 bytes.
  84.  
  85.       Splitting a file.
  86.       ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  87.       Click on the 'SPLIT' button and use the fileselector to choose the 
  88.       file to be split. The size of each split block will depend on the 
  89.       setting previously defined.
  90.  
  91.       Rebuilding a split file
  92.       ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  93.       Click on the 'BUILD' button and use the fileselector to select the 
  94.       *.000 file which will be rebuilt. Once selected you will then be 
  95.       asked to choose the path for the file to be rebuilt into.
  96.  
  97.       Checking a split file
  98.       ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  99.       Click on the 'CHECK' button and use the fileselector to select the 
  100.       *.000 file to be checked. No action will be performed apart from the 
  101.       integrity of each split block being checked.
  102.  
  103.       For support or suggestions contact..
  104.       ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  105.  
  106.       Authors: Stuart Coates & Mark Matts
  107.       Address: 66 Telford Way, Leicester, LE5 2LX, England.
  108.  
  109.         Or if you have a modem..
  110.  
  111.       Mark Matts on: AtariNet: 51:6/200.0@atarinet.ftn
  112.                      NeST: 90:100/300.0@nest.ftn
  113.  
  114.       Stuart Coates on: AtariNet: 51:6/204.0@atarinet.ftn
  115.                         NeST: 90:100/304.0@nest.ftn
  116.  
  117.       BBS: System ST, upto 14400baud, online 10pm to 7am UK times..
  118.  
  119.       Updated version information
  120.       ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  121.       version 1.1 - Released (04/06/93)
  122.  
  123.       o Changed selectable block sizes to be in 100k steps rather than 10k 
  124.         steps, this made more sense as you can now split a large file into 
  125.         a 720k block to save having too many split files for one large file!
  126.       o When re-building a file you can now select where you want to have 
  127.         it rebuilt instead of it re-building automatically in the split 
  128.         file folder.
  129.       o If you selected a block file and it was incorrect or corrupted you 
  130.         could still click on the 'Rebuild' button even though there was 
  131.         nothing to actually rebuild due to the error, this is now fixed.
  132.  
  133.       version 2.0 - Released (29/03/94)
  134.  
  135.       o Splitting routines now rewritten in ANSI 'C' to allow support for 
  136.         split files on other platforms.
  137.       o New GEM shell written for the new Splitte program.
  138.  
  139.                         ---- Happy file splitting ----
  140.  
  141.